<html xmlns="http://www.w3.org/1999/xhtml">
<head>
 <title>LZXリファレンス lz-vscrollbar</title>
  <othercredit role="translator">
    <firstname>Hiroyuki</firstname>
    <surname>Kato</surname>
        <contrib>2006/05/16　翻訳初版</contrib>
 </othercredit>
</head>
<body>

<!-- ===================================================================== -->
<!-- = XML information goes here                                         = -->
<!-- ===================================================================== -->
<lzelement title="Vscrollbar">
    <lztier>LZ Components</lztier>
    <lzcategory>View</lzcategory>
    <lzshortdesc>
             垂直方向のスクロールバーを提供します。
    </lzshortdesc>
    <lztag>lz/vscrollbar.xml</lztag>
</lzelement>

<p>このタグは垂直方向のスクロールバーを作成します。<attribute>scrolltarget</attribute>
を指定しない場合、スクロールバーは自動的に右寄せになり、親要素の高さに合わせて（高さが）リサイズされます。
親ビューがscrolltarget（で指定されている要素）よりも小さく、且つ親ビューに<code>clip=true</code>
が設定されていることが前提となっています。スクロール効果は親ビューによってscrolltargetの可視領域が切り取られている間、
scrolltargetを移動させることで生み出されます。</p>

<p>ターゲットとなるビューをスクロールしたいのであれば、単純にy属性を負の値にして下さい。例えば、
<code>y=-10</code>とすることで10ピクセルだけそのビューをスクロールさせることになります。
</p>

<note>アプリケーション内に水平方向のスクロールバーがない場合、 <tagname>vscrollbar</tagname>
タグを使用することで<code>&lt;scrollbar axis="y"&gt;</code>と記述するよりも
アプリケーションのファイルサイズを僅かに小さくすることができます。</note>
 
<example title="Simple scrollbar">
&lt;canvas height="160" bgcolor="silver"&gt;
  &lt;view name="main" x="20" y="20" bgcolor="white"
        width="100" height="80" clip="true"&gt;
    &lt;view name="contents"&gt;
      &lt;text multiline="true"&gt;
        1&lt;br/&gt;2&lt;br/&gt;3&lt;br/&gt;4&lt;br/&gt;5&lt;br/&gt;6&lt;br/&gt;7&lt;br/&gt;8&lt;br/&gt;9&lt;br/&gt;10
      &lt;/text&gt;
    &lt;/view&gt;
    &lt;vscrollbar/&gt;
  &lt;/view&gt;
&lt;/canvas&gt;
</example>

 
<p>上記の例では、scrolltargetは<varname>contents</varname>という名前のビューです。スクロールバーは
<attribute>scrolltarget</attribute>をaxis属性にあわせて移動させます。
このスクロールバーによって制御されている属性は<attribute>scrollattr</attribute>のデフォルト値である
<code>x</code>若しくは<code>y</code>をオーバーライドすることで設定することができます。</p>

</body>
</html>
<!-- * X_LZ_COPYRIGHT_BEGIN ***************************************************
* Copyright 2001-2004 Laszlo Systems, Inc.  All Rights Reserved.              *
* Use is subject to license terms.                                            *
* X_LZ_COPYRIGHT_END ****************************************************** -->
